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INTRODUCTION TO THE PDP-1 TIME SHARING SYSTEM 

GENERAL INFORMATION 

This memo "was written to give the new user a brief 
introduction to the PDP-1 time sharing system programs- 
The material presented is sufficient information needed 
to operate in the TS system^ however, only the essential 
features of the system -programs are described. Other 
useful and time saving features are described in the 
respective program memo. 

The computer has three 4096-word core memories, one is 
used for executive control of the system and the other 
two are available to the users * In addition to these three 
4096 -word core memory, an extra amount of memory in the 
form of a magnetic drum is aba liable. The storage space 
on the drum is broken up into a number of "fields", each 
of which has the capacity to store 4096 18-blt words. 
This drum memory (besides being used for the time- 
sharing operation) can be used to store programs and 
data when there is not enougih room in core. It is also 
used as a permanent storage space for "utility" programs 
which can be used by you. 
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To execute a program that you have written for the 
PDP-i, you must do the following things ; 

1) Tell the computer, in some way, the sequence of 
ma chine -language instructions that make up you program. 

2) Have the computer translate or assemble these 
instructions into a sequence of binary words. 

3) Place this binary program into core memory and 
have it executed, and 

4) check your answers to see if your program is 
working correctly. 

The permanently stored utility programs will be of 
help to you in accomplishing the above tasks. One of the 
programs, EXPENSIVE TYPEWRITER, assists you in reading in 
your machine-language program, producing a binary program, 
DDT is an all-purpose program that will see to it that 
your program is executed. It also allows you to inspect 
and test your binary program for proper operation. 

Each of the three utility programs mentioned above 
is stored (in binary form) on a different field of the 
magnetic drum. Of course, in order to use a program you 
must first place it in core memory. This is done by 
typing the commands shown In Figure 1. 
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Figure 1. 

For example, turning the console switch off, then turning It on, 
will bring the program DOT from drum to core. Anything typed 
by you at this po. nt will be interpreted as a command to DOT* 
Typing 61U* then OC will cause EXPENSIVE TYPEWRITER to be brought 
into core* Anything typed at this point will be interpreted as 
a command to EXPENSIVE ^YPEWRiy SH. • 

The features of each cf ^ne programs will now be described. 



* 



The letters typed by you will be underlined in this paper. 
Those typed by the computer will not be underlined* The 
symbol is a carriage ref urn 
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EXPEMSIVE TYPEWRITER : 

This program is used for the reading in or typing in of 
your machine language program* It is also valuable in modifying 
your machine language program— with it you can do such things 
as changing lines, inserting lines, deleting lines, etc. This 
program has a buffer storage area where a copy of your machine 
language program is kept, When you enter EXPENSIVE TYPEWRITER 
by typing 6lU then OG to DET, this buffer area is cleared . 
Entering E.T. by typing 6iU then 2G will not clear this buffer. 

E.T. has two operating "modes", control mode and text mode. 
In the control mode, characters typed in are commands to 
EXPENSIVE TYPEWRITER; in the text mode, typed input is copied 
directly into the buffer. The only exception to this is the 
character "backspace" which in the text mode has the effect 
of cancelling the previous character. To go from text mode 
to control mode, type a backspace immediately following a 
carriage return or after deleting all characters from a line. 

Certain commands in the control mode put E.T. into the 
text mode* In the control mode, the typewriter prints in 
red, and in the text mode it prints in black. A lower 
case conanand is terminated by typing in a carriage return 
or t§£; at any time before the terminator is typed the 
command can be cancelled by typing the character middle 
dot (*). 
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Commands to EXPENSIVE TYPEWRITER: 

In the examples below, the letter N is used to signify 
the number of a line* (A carriage return denotes the end of 
a line-) For example, the title line of your program will 
be line one, etc. Slash (/) or period («) may be used for 
the N to signify the last or current line number, respective ly. 
I* Input: 

&S append. Enter the text mode* add the following 
typed text onto the end of the previous contents 
of the buffer; the buffer already has a stop 
code at the end. 
Jli.: insert* Enter the text mode? insert the 

following typed text immediately before line N. 
That is, the first line of the inserted text 
becomes the new line N* The text is squeezed 
in between the old lines N-i and N; no material 
is lost* 
JJS.: change. Enter the text mode. Line N is entirely 
deleted and the following typed text is inserted 
in its place; any number of lines may be inserted, 
r: read. The tape in the reader is read in and 
appended to the end of the buffer. 
II. Deletion of Information in the Buffer: 
Ng : delete. Line N is deleted. 
K: kill. The entire buffer is cleared. 
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III, Printout: 



W: write. The buffer is printed out (in black )* 
Ni: line* Line H is printed out (in red). 
backspace: prints out the next line 

f : prints out the previous line. 
IV- Punching Tape 

P: punch, This punches the buffer out on paper tape 
V. Transfer 

N: transfer control to POSSIBLE 
b«* transfer control to DDT 
VI. Search 

s~: limited * 

§T: unlimited. Search the current page (limited) 
or the entire buffer (unlimited) for the first 
occurrence of the string anywhere in the text 
buffer- If none is found, ET types "missing". 
Otherwise the search command is replaced by the 
line number where the string was found* 

Typical Operating Procedure - 

Probably the first time you use the computer you will 

enter E.T. by typing 6lU then 00* Your program buffer will 

be clear. If you have prepared a FIO-BEC program using the 

off-line f lexowriter, you may read It Into the EXPENSIVE 

TYPEWRITER text buffer by typing r. In reading the tape in, 

first, insert your tape with the 5 -ho led side toward you. 

The input side is the right and the tape feeds from right to 

left- 
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Turn the reader switch on at the main console by lifting it 
up. Typing r will read the tape into the buffer. After the 
tape is read in, turn the reader switch off by pressing it 
down and remove the tape from the reader, If a tape of your 
program has not been made, typing A, then your program M will 
put your program into the buffer. After correcting any typing 
mistakes using the delete, change, etc. commands, you will be 
ready to enter the POSSIBLE program where your program will 
be assembled, To enter POSSIBLE type a capital .g. 

When you have a program in E,T*'s buffer, you can get 
a punched copy by typing the command P, Your tape will 
automatically be punched* After punching, press the tape-feed 
button on the main console to give you a cduple of extra 
fanfolds of tape, and tear off your tape. This tape can 
now be used on another attempt to run your program. In this 
way it Is not necessary to retype your entire program every 
time you run, You should also get a typewritten copy of the 
machine language program by typing W. Lifting Sense Switch 1 
while the buffer is being typed out by a W will stop the 
typing. 

The E.T. has one all-purpose error signal -'?. If a 
? is typed by E,T. after you have typed something, examine 
what you have done carefully. 
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Imp orta nt Reminders ; 

1) The meaning of the backspace key to EXPENSIVE TYPEWRITER 
differs depending upon the mode of operation. If E.T» is in 

fck® control mode , the backspace key means: print out the 
next line (if no previous line has been mentioned, this will 
print out the first line). If E.T* is In the text mode , the 
backspace key has two meanings • if a letter of text ha3 
been typed by you a backspace erases it* If a backspace 
follows a carriage return typed by you, it means: return 
to the control mode* Do not attempt to type a comm and 
to EXPENSIVE TYPEWRITER unless it is in the control mode* 

2) After you type in your program and leave EXPENSIVE 
TYPEWRITER, ' you will probably want zo return later to make 
further changes to your program. When entering E«T. from 
DDT the second time, be sure to enter by typing 6iU then 2G. 
A OG will erase your program entirely., 

3) Remember every lower case command to EXPENSIVE TYPEWRITER 
must be followed by a carriage return before it Is executed. 

4) It Is a good idea to print out the line you wish 
to modify using the command Nl before and after the change 
is made* This way you can be sure that you are changing 
the right line and that the change was made correctly . 

5) After making any changes to your machine -language 
program with EXPENSIVE TYPEWRITER you must always reassemble 
your program with POSSIBLE If you want to get a new binary 
progx*am. Therefore, you should leave EXPENSIVE TYPEWRITER 
using the N command to POSSIBLE rather than the b command to 
DDT, 
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The POSSIBLE program when entered by N will assemble the 
machine-language program >*hich is located in the buffer of 
EXPENSIVE TYPEWRITER* The assembled binary program is placed 
automatically on drum field 1, unless specified that a tape 
is desired* 
Sommfrfids tp.^SSIBLE: 

s: begin assembly 

c: continue assembly 

§. : punch symbols 

b* transfer to BET 

ic: constants area 
Operating Procedure ; 

When you enter POSSIBLE with your machine-language program 
stored in the buffer of EXPENSIVE TYPEWRITER, typing a s will begin 
pass i of the assembly. If an error is discovered during 
assembly an error signal will be printed out in the format 
described below and the assembly process will cease « 

If an error is found on pass 1, first type £ to continue 
pass 1. Then return to EXPENSIVE TYPEWRITER by typing b then 
612 tnen £§* 3.* 1 order to correct your machine language program* 
After the corrections have been made* return to POSSIBLE with N 
and try pass i again* If pass i assembles correctly, no error message 
will be printed out* In this case, type s to initiate pass 
2* Error in assembly during pass 2 result exactly as in pass 1 
and you should proceed as described above,, 



*£Q< 



If both passes assemble correctly you may, if you desire, 
receive a paper tape punched with your table of symbols by 
typing &• Also by typing k the constants storage a^a will 
be printed out- After your program is assembled by POSSIBLE* 
you will want to return to DDT to run it and find errors if 
they exist- Typing b will cause you to leave POSSIBLE and 
return to DST. 
Error Signals: 

Upon detecting an error, POSSIBLE will print out the following: 

aaa bbbb ccc dddd eee 

aaa is the three letter code indicating the error, bbbb is 

the octal address at which the error occurred, ccc is the 

symbolic address at which the error occurred, dddd is the 

name of the l83t pseudo-instruction encountered. In the 

case of an error caused by a symbol, eee will be the symbol* 

Following is a list of the error indications in POSSIBLE. 

ERROR MEANING 

nca NO CONSTANTS AREA 

The pseudo-op constants is needed. 

llf ILLEGAL FORMAT 

lit ILLEGAL TAG 

Tag which is not a single symbol is 
not equal to current location, 
ex. foo+10, ^current location 

mdt MULTIPLE DEFINED TAG 

Tag consisting of a single defined symbol 
is not equal to current location. 
Symbol is not redefined. 

usw UNDEFINED SYMBOL 

A symbol which has not been defined in 
program is encountered. Symbol is given 
the value of zero if assembly is continued. 
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BRROR MEANING 

eld CONSTANTS LOCATION DIFFERENT 

^ e constant pseudo-op appears in different 
location on pass 2, No recovery can be made. 

vld VARIABLES LOCATION DIFFERENT 

Same as eld but for variables. Often 
possible to recover by ignoring this* 

ild ILLEGAL DEFINITION 

Program attempts to redefine pseudo-op 
or previously defined symbol. Redefines 
pseudo-^op or symbol if assembly continued. 

see STORAGE CAPACITY EXCEEDED 

Storage of macro definitions, macro arguments, 
repeat ranges, numerical constants (pass i), 
unique constants (pass 2), symbols, or macro 
names has Ipieen filled. No recovery can be made. 

pee PUSH DOWN CAPACITY EXCEEDED 

Macro, repeat, or constant nesting is 
too deep or too complicated arithmetic 
statements are used. No recovery can be made. 

tme TOO MANY CONSTANTS AND VARIABLES PSEUDO-OPS 

Total number of constants and yarJLafr l ft s, 
pseudo-ops in 2Qq. No recovery can be made. 

mdd MULTIPLY DEFINED DIMENSION 

Symbol representing first location in 
dimension of array is already defined. The 
old symbol definition is retained if 
assembly is continued. 
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tmt TOO MANY TERMINATE PSEUDO-OPS 

There exiat more terminate Instructions 
fcnan 4eflne. Instructions * The tgrm^n^te 
is ignored if assembly is continued.. 

Ids ILLEGAL DIMENSIOH SIZE 

Specified dimension size is negative. 
Dimension size is set to zero if assembly 
continued* 

ich ILLEGAL CHARACTER 

Input source has an illegal flexo code 
or character. Number typed is the 
illegal character.! if the number is in 
the 40G*s it is an upper case character. 
Continuing assembly, will ignore the 
character* 

DDT* 

This program is a very valuable aid in debugging and testing 
your binary program » It allows you to examine the contents 
of locations of core, to change the contents of these locations, 
to run your program, and to make use of breakpoints „ When 
in DDT, all typing will be performed In black. After a command 
is typed by you, DDT will type a carriage return to indicate 
that the command was carried out* Therefore, do not type a 
carriage return after a command as you would do In EXPENSIVE 
TYPEWRITER • 
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Commands to PET 

Control 

2T Typed immediately after returning from POSSIBLE 
assembly o This places your symbols and their 
values into the EOT symbol table. This allows you 
to use symbolic addresses when communicating 
with DOT* 

NU where N is a number. This takes the program from 
drum field N and places it in core memory so that 
it can be executed. Your binary program has been 
placed on drum field 1. EXPENSIVE TYPEWRITER is 
on absolute drum field 21. MACRO is on absolute 
drum field 22. (Absolute drum fields are indicated 
by the sign bit being on; thus, absolute field 21 
is obtained by typing 6lU . ) 
locG This will cause the computer to begin executing 

the program which is in core starting at location 
loc. loc may be either a symbolic expression or an 
absolute number* 

For an example of the above commands: 

2T 

is 

will enter your symbol table from POSSIBLE into DDT a s 
symbol table from POSSIBLE, bring your program from 
drum field 1 into core, and begin executing your 
program at location beg. 
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Examine a Register 

%dr/ : Types out the contents of register adr* 
"adr" may be a symbolic address or an 
©stal number * 

Examples : beg;-t-2/ types out the contents 
of the register 2 positions 
past beg* 5 5/ types out 
the contents of register 55c 
Change a Register 

adr/ expJ Changes the contents of register 
adr to exp* 

Example? k^ 4 lj $ examines 
the contents of the register k and 
finds it contains the number 4„ This 
is changed to 13 • 
Set the Mode 

& Sets EOT to type out all words as 

symbolic instructions. 
£ Sets DOT to type out all words ae 

octal number * 
Examples : g 

20/ and k 

2 

20/ 020003 (if k « 3) 
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U Converts all numeric printouts to 

decimal . 

H Resets DOT so that all numeric printout 

are in the normal octal mode again. 

Examples : C 

20/ 020003 

20/ 8195 

H 

20/ 020003 

Convert an Expression 

e*P » Types out the value of the expression 

exp as an octal number. 
num-Hfc. Types out the octal number num as an 

instruction. 
char ~ Types out the character (s) char as 

concise code. 

Examples: 20/ 20003 — -^ and K 

(if kf^3T 

beg « 20 (if beg is the 

symbol for location 20) 

a40~ 610420 
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Examining Sequences of Register 

adr/ M« t Opens the register preceding adr and 

types its contents. 
Example: tab/ 13 t 
tab-1/ 21 £ 
tab~2/ 
Register tab contained 13, tab-1 
contained 21, and tab~2 contained 0* 
adr/ oc« (bs) Opens the contents of the register next 

in sequence to adr and types out„ 
(bs) means back- 
space Example: tab/ 13 (bs) 

tab+1 6l 
Register tab+l contains 6l 
ateZ -•• (£afe) Types out the contents of the 

register addresses by the contents 
of register adr* 
Example: §£&/ lac 13 tab 44 
Register 13 contains 44 
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It is tempting to load a newly coded program into the 
computer* let it run to completion* and check the final answer 
for correctness. Becauae of the high probability of one or 
more errors in even short programs and the cumulative effect 
of these errors , this approach is practically worthless 
(except for very short programs)* 

A more satisfactory approach is to run only a small portion 
of the program at a time and check intermediate results*, 
This allows one to catch errors before they have a chance t-> 
make the whole operation unintelligible* The breakpoint 
feature of DQKP permits one to take this approach and check 
out one section of the program at a time* 

A breakpoint is a place in the user's program where 
computation is Interrupted and control Xa transferred to DDT* 
This is accomplished by removing and saving the instruction 
at the breakpoint and inserting In its place a jump instruction 
to WE* 

When the program reaches this Jump, the status of the 
machine (AC, 10, overflow indicator, etc « ) is saved and the 
breakpoint location and contents of that j oration are typed out* 



At this point one may examine the intermediate results 
by use of any of the inspection and modification commands 
listed above. If they are satisfactory, one may proceed 
with the next section of the program. If they are in error, 
one may try to correct the errors and re-run the section* 
The DITT breakpoint commands are as follows: 

locg Prepares DW to insert a breakpoint at 

location loc. The actual insertion occurs 
when a G or X command is given,, 
IL, Removes the previous breakpoints, 
P Given after a program has teen interrupted 

by a breakpoint. The instruction removed foi 
the breakpoint Is executed and control is 
returned to the user's program. 
InsX Causes instruction ins to be executed , 
Examples : 

lupB 

lup) add sym 

U 4 

P 
This example places a breakpoint at location lup and 

transfers control to beg. The content of register lup is 

add sym and location k contains 4 at the break. The breakpoint 

is removed and the program is allowed to proceed * 

4231 ££S£ deposits +0 into register con 



